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It’s a plot! 


See Work creates 
bar, line, pie charts 
from Worksheet data 


One of the best functions of the more 
advanced spreadsheet programs is chart- 
ing — the ability to create graphics from 
the data you’re working with. 

With the Re:Port exclusive program 
SeeWork, the Portfolio Worksheet now 
has that capability. 

Using graphics to display spreadsheet 
data can be a great help in finding hidden 
patterns in numbers that you would not 
have seen otherwise. 

To use SeeWork, copy the files 
SEEWORK.EXE and WORK.BAT 
(from the \SEEWORK directory on 
Re:Port disk #5) to your Portfolio. Op- 
tionally, copy SEEWORK.PGC to the 
same directory; this will give you visual 
confirmation that SeeWork has been 
loaded. When you type WORK, the 
program will automatically launch the 
Worksheet application. 

(IMPORTANT: Before using 
SeeWork, you must go into the Portfolio’s 
setup menu by hitting Atari-S. Then hit 
A for Applications. A menu will appear, 
and the first selection will be “Clipboard 
save.” Ifthis is set to Off, then you need 


ii) SeeWork can be 
@. found on Re:Port Disk 
J #5 in the \SEEWORK 


ON DISK subdirectory. 


SeeWorks’s bar, line, and pie charts 


to hit C to turn it On. 
Once it is On, hit ESC 
twice to get back to what 
your were doing.) 

When you’re in the Worksheet, 
choose which data you would like to 
plot. To do that, move your cursor to 
the first data cell that you would like 
to plot. Hit Fn-3, and the Clipboard 
menu will appear. Hit M for Mark. 
Now, move your cursor to the last 
data cell to plot. Hit Fn-3 again, but 
this time press S for Store. 

When you quit the Worksheet 
(press ESC), you will go to a Func- 
tion menu. This is the SeeWork 
program itself. 

Continued on Page 4 


What's Inside 


e Find out about 
hard drives and car- 
rying cases in Indus- 
try News. 

Page 3 


e HyperList is fi- 
nally available. But 
what does it do? 
Read all about it. 
Page 4 


e View and edit 
Portfolio graphics on 
your desktop and on 
the Portfolio with 
threeincredible pro- 
grams. 

Page 6 


e Beginners: Learn 
how to transfer files 
from a floppy disk to 
your Portfolio. 
Page 8 


e Programmers: 
Use our new pro- 
gramming library to 
create Portfolio 
graphics applica- 
tions. 

Page 10 


The contents of this newsletter and diskette are ©1992 Re:Port, except where noted 


Portfolio is a trademark of the Atari Corporation 


May/June, 1992 


Page 2 Re:Port 


From the Editor 


Sell your old Port items in Re:Port classified 


You may notice a slant toward 
graphics in this issue of Re:Port. It 
may be hard to believe, but the Port 
does graphics quite well, as the pro- 
grams you’ll be using prove. 

Many thanks to Don Thomas of 
Artisan Software for providing his 
shareware ViewPort program. Also, 
thanks to everyone who has written 
in with articles and tips for other 
readers. We encourage everyone to 
chime in with their own Portfolio 
stories to share. 

Recently, one user reported that 


Port uses 


he no longer had a need for his 
parallel interface because he bought 
a serial interface. He wondered 
whether there might be a market for 
used Portfolio items. There might 
be. If you have a Portfolio product 
that you’re no longerusing, or if you 
need one cheap, you’!l want to take 
advantage of our new feature, 
Re:Port Classifieds. 

Send your classified ad ($3.50 
for 25 words or less, $5 for 26 to 50 
words, $7 for 51-100 words) to 
Re:Port classifieds, 1618 S. Beech 


Ct., Broken Arrow, OK 74012- 
6205. If there is a large enough 
demand for the classified ads, they 
will be printed along with the “Sav- 
ings Surge” flier, so that they will 
not take up any space in the newslet- 
ter. 

Remember that back issues are 
available for $10 each. Or, you may 
order all four back issues at once for 
$35. 

Enjoy this issue, and let us (and 
other users) know what you do with 
your Portfolio. 


Officer uses the Portfolio to keep the streets safer 


By Gregory Kranich 

The long arm of the law has a 
Portfolio in its hand. At least that’s 
the way I put it to Don Thomas at 
Atari Corporation while discussing 
my use of the Portfolio at the San 
Jose Police Department. 

My tour of duty begins with a 
daily briefing. This is where offic- 
ers receive information such as the 
major crimes in the last twenty-four 
hours and wanted persons or ve- 
hicles. Port’s built-in text editor 
handles this quite nicely. Briefing 
information is primarily short notes, 
names, brief descriptions and license 
plate numbers. 

After briefing, I get my car and 
equipment (including my four meg 
Atari STacy portable computer) and 
hit the streets. I am quite practiced 
at driving and, after seeing a person 


or car that may be wanted, reaching 
for the Port. Then, it is a one- 
handed operation to open the text 
editor and scroll the information to 
the desired point. Icanthen confirm 
a license plate or a person’s descrip- 
tion to determine if I want to take 
any further action. Several criminal 
types have been foiled this way! 
The address book contains a list of 
the police units or support agencies 
that I need to contact from the field. 

One of the most common calls I 
receive is a traffic collision. Ifit’s a 
serious one I will almost certainly 
be handling diagraming (where the 
STacy comes in), measurements and 
calculations for skid mark analysis. 
Out comes the Port. The built in 
spread sheet is set up with numerous 
skid analysis formulas. I can calcu- 
late straight skid, curved skid, skid 


over several different surfaces, flips 
and nearly anything else someone 
can manage to do with a car. Of 
course, the results can be printed for 
later use in court. Any Port user that 
also has a GEnie account can obtain 
this .WKS file. Just log on and visit 
ALERT (A Law Enforcement 
RoundTable). We’re located on 
page 255. The .WKS file is #130 in 
the ALERT library. 

The Port is my “silent partner” 
and constant companion. There are 
several more applications that I in- 
tend to obtain which will make it 
even more useful in the war against 
crime. 

a 
¢ Gregory Kranich is a former 
Detroit Police Officer and has spent 
the past 10 years with the San Jose 
Police Dept. 


Re:Port 


Page 3 


Industry News 


Hard drives, carrying cases available 


Unfortunately, one good rumor that was circulating 
during the past two months isn’t true. Someone was 
passing around information that Megabyte Computers 
of Texas was distributing 1 megabyte RAM cards for 
about the price of a 128K card; alas, this isn’t the case. 

However, Jim Leslie, the general manager of Mega- 
byte, says that the company had been thinking about 
such a project but that it would cost as much or more 
than the 20 megabyte hard drive the company offers. 

Megabyte has the BSE Flashdrive hard disk for the 
Portfolio, in three sizes. A 20-meg drive is $399, a 40- 
meg drive is $549, and while supplies last, an 80-meg 
drive is $549, the same price as a 40-meg drive. Jump 
on this one if you can, but call Megabyte at (817) 589- 
2950 first to make sure they are still in stock. 

The BSE Flashdrive is an excellent storage option 
for the Portfolio, but you will need a parallel interface 
to make it work. However, the Flashdrive will connect 
to your desktop computer as well, which makes it a 
good way to transfer data between machines. 

Megabyte also still does the 512K internal upgrade 
to the Portfolio, as we have reported before. The cost 
is now $299, and includes a six-month warranty on the 
upgrade (the upgrade voids the Atari warranty). Your 
computer is shipped back to you for $5 UPS ground, 
$10 2nd-Day Air, or $15 next-day air. If you’re in the 
market for a completely new 512K Portfolio, they sell 
those for $529. 

PORTFOLIO CARRYING CASE 

Great news for users who travel with their Portfolios. 
A high-quality carrying case, designed exclusively for 
the Port, is now available. 

This black padded nylon case has room for the 
Portfolio itself in one pocket, and both of your inter- 
faces in the other pocket (or a serial interface and a 
pocket modem). Pockets in a divider between the 
bigger pockets give you space for four coverless RAM 
cards, or two RAM cards in their clear plastic covers. 
The carrying strap may be lengthened from a hand strap 
to a shoulder strap. 

A unique feature of this case is a battery/AC adapter 
pack that hangs from the shoulder strap. This has 


enough room for an AC adapter, but at Re:Port, we use 
it to carry six AA batteries and modem cables and 
connectors. 

According to the manufacturer, the price for the case 
is $29.95 and $3 shipping for cases sold outside Cali- 
fornia. In California, add 8.25 percent tax. The case for 
the AC adapter is an extra $4.95, plus tax in California. 
Cases are shipped when the check clears, and are 
covered by a 30-day warranty with a full refund (minus 
shipping). 

To order a case or to find out more, contact Rumi 
Murakami, 1757 Walnut St., El Cerrito, CA 94530, 
(510) 232-1057. 

Re:Port editor David E. Stewart, an avid user of the 
case, reports that it is an effective way to travel with the 
Portfolio and all its various attachments and cards. 

HTX HYPERTEXT RELEASED 

Kent Peterson, author of HTX, the hypertext system 
for the Portfolio, says that the new version of the 
program will be available by May 1. You may remem- 
ber this from past “Industry News” columns. 

HTX includes hot-keys to the Portfolio’s built-in 
applications, a mini manual, and a run-time version. 
Peterson says the new version is “feature-packed,” but 
no demo ofthe program was available as ofthis writing. 
We’ll have a full review in the next issue. 

Peterson is offering HTX for $55.25 to Re:Port 
subscribers. The program comes on an IBM diskette. 
Send your orders to Re:Port, and we’ll forward them. 
(Re:Port will upgrade you to a Macintosh disk for 
another $10). Those of you who have orders for HTX 
in already and have been waiting will have a $5 gift 
certificate in your package when it arrives soon! 

EUROPEAN SOFTWARE DISTRIBUTION 

Programmers will be interested to note that acompany 
is willing to distribute your shareware programs in 
Europe. Contact TAC USA-CH at (310) 446-6000 ifyou 
want your programs to go to Portfolio users overseas. 

Re:Port also welcomes shareware and freeware pro- 
grams for distribution. Please contact us at (918) 258- 
2062. Re:Port is distributed to users in eight countries, 
including Japan and Australia. 
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Review 


HyperList here at last; now what? 


After months of waiting, Atari 
has finally released HyperList. 

But now that it’s here, what is it? 
Atari has not even been able to 
describe the product simply, but 
perhaps the best description we’ve 
been able to find is “Address Book 
with an Attitude.” 

If you’ve ever been limited by 
what the built-in Address Book ap- 
plication can do, you might find an 
answer in HyperList ($49.95 retail; 
$40.96 to subscribers; supplied on 
ROM card). 

At its highest level, HyperList is 
an outlining program. You can en- 
tera list of topics (similarto the card 
titles of the Address Book). At any 
topic, you may hit Shift-Enter to 
create a sub-topic. Any sub-topic 
may contain any number of further 
sub-topics. 

Beyond that, any topic or sub- 
topic may contain a sub-note, cre- 
ated by hitting Ctrl-Enter. A sub- 
note is simply any amount of text 
used to describeatopic. This is very 
similar to the text part of an Address 


From this menu, you may choose a Bar, Line, or Pie 
chart. Try each one to see how they work. 

Inthe Barand Line charts, azero line is always drawn 
to give you a reference point. The highest value from 
your worksheet is plotted at the top of the screen; the 


lowest value is at the bottom. 


The Pie chart is plotted clockwise from the “12- 


o’clock” position. 


Once you’ve chosen a Bar, Line, or Pie chart, you 


Bookentry, except that data is much 
easier to enter. A sub-note may not 
contain more sub-notes or any sub- 
topics. 

Let’s look at a specific example, 
one that shows the difference be- 
tween the Address Book and 
HyperList. 

Begin with a list of names, such 
as John Doe, Bill Smith and Judy 
Doe. Under each name (or topic), 
you may include any number of 
sub-topics, such as Address, Phone, 
Work hours, and Notes. Under each 
topic, you create a sub-note, which 
includes the actual text, such as each 
person’s address. 

But to further illustrate 
HyperList’s power, let’s create a 
couple of sub-topics under “Phone” 
instead of a sub-note. Under 
“Phone,” wetype Shift-Enterto cre- 
ate a new list of sub-topics, Home 
phone and Work phone. 

Then, under each of those sub- 
topics, we’ll create a sub-note by 
hitting Ctrl-Enter and adding the 
actual numbers. HyperList, like 


GEO WOLLK continues rom rare 


may choose Save graphic. Type in a filename when 
prompted, and be sure to add the .PGC extension (i.e. 


PIE.PGC). 


Address Book, can actually dial the 
numbers, too. 

HyperList also includes some 
powerful business tools. People 
who keep customer records on the 
Portfolio may want to convert them 
to HyperList records because of the 
Tally function. 

Tally allows you to add all the 
numbers within a list or sub-list. If 
you haveaclient record in HyperList, 
which includes all of the purchases 
that client has made, simply choose 
Tally and HyperList calculates the 
total bill, and places that total next 
to the client’s name. 

Once you’ vecalculated all of your 
client’s bills separately, HyperList 
can then total all the bills for you 
with the same Tally command. 

HyperList also can import Ad- 
dress Book files for easy conver- 
sion. 

HyperList comes ona ROM card 
with a complete printed manual and 
several handy example files (such 
as an area code listing and a plan- 
etary database). 


Your graphic will be stored as a compressed Portfo- 
lio graphic, which can be edited or viewed with two 


other Re:Port utilities (see Page 6). 


To return to your Worksheet (possibly to select new 


data to plot), hit W for Worksheet. To quit both the 


Worksheet and SeeWork, press Q for Quit. 
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PBASIC 


PREAD squeezes text files in small spaces 


By B) Gleason 

© Copyright BJ Gleason, 1992 

PBASIC 4.9 comes with a 50+k documentation file 
filled with important information on using the inter- 
preter and programming inthe PBASIC dialect. Due to 
the size of the document, it is impossible to hold both 
the interpreter, the programs, and the documentation on 
a RAM card. 

To help take care of this RAMcard crunch, I have 
created a utility called PREAD. This program will 
convert a text file to a.COM file with a built-in viewer. 

Show File [SF.COM] is a simple file viewer for the 
Portfolio. It quick and tiny, and about 1k in size. It will 
quickly allow us to view document files. We can page 
through them and quickly move from the beginning to 
the end of the text and back. PREAD has a version of 
SF designed to place at the beginning of a text file. 

With the PREAD system, we take a document, merge 
it with a file viewer like SF and make it a program. To 
read the document, just run the program. For example: 

MAKEREAD pbasic.txt pbdoc.com 

This will convert the PBASIC document to an ex- 
ecutable file called PBDOC.COM. You can delete 
PBASIC.TXT, and view the documentation by typing 
PBDOC at the prompt. 

What is the benefit ofthis process? We have actually 
made the text file larger! Well, here is the nifty part. 
Now that the text file is an executable program, we can 
compress it with a program like PKLITE or LZEXE. 
When we compress PBDOC.COM with PKLITE, to 
reduced by almost 60%! The PBASIC documentation 
has been squeezed down to 20k in size, freeing up 30+k 
of room onthe RAM card. We can read the document, 
search it, scroll and through it at will. 

All the files needed to do this conversion are in- 
cluded on Re:Port disk #5 in the PREAD subdirectory. 
It contains a documentation file (in the PREAD for- 
mat), the MAKEREAD program, and PREAD.HDR, 
the actual program that get added to the front of the 
document. You can also find PKLITE and LZEXE in 
the APORTFOLIO libraries on CompuServe, as well as 
on many other online services and at various software 
vendors. 


Gleason on PBASIC 
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3 PREAD files can be found on Re:Port Disk 
ON DISK #5 in the \PREAD subdirectory. 


USING PREAD 

You can create your document using any standard 
ASCII text editor. With the Portfolio, the built in editor 
is fine. Set the word wrap ON for up to 39 characters. 
This viewer can not handle lines that are wider than the 
screen. 

The document can not be longer than about 60000 
bytes, since, when combined with the file viewer, and 
the compression program, it can not exceed 65200 
bytes in size. 

When preparing your document, you should also 
consider adding chapter markers. 

A chapter marker (~) is the ASCII character 254, 
which can be inserted by holding down the <ALT> key 
and pressing 2 5 4 on the keypad. 

The user can easily move back and forth between 
these markers using the <TAB> key to move forward to 
the next marker, and <SHIFT><TAB> to move back to 
the previous one. 


About the Author 


Mr. BJ Gleason is an Instructor at The 
American University in the Computer Sci- 
ence and Information Systems Department. 
He has been programming for over a decade 
now, and is the author of PBASIC 4.9. 

You can write to him at: 

BJ Gleason 

The American University 

CSIS (Thin Air Labs) 

4400 Massachusetts Avenue, N.W. 
Washington, DC 20016 
CompuServe : 75300,2517 
EMAIL : bjgleas@auvm.american.edu 
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3 programs view, edit Port graphics 


The Portfolio’s graphics capa- 
bilities are constantly being ex- 
plored. Amazingly, this little ma- 
chine built for text processing can 
handle graphics, and very quickly, 
too! 

Programmer Don Messerli of 
Software Vineyard stays on the cut- 
ting edge of graphics programming. 
He and columnist BJ Gleason have 
developed the .PGC file type, which 
stands for Portfolio Graphics Com- 
pression. This file type can store a 
full-screen Portfolio graphic in less 
than 2K of disk space! 

Messerli has also developed a 
method of animating .PGC files in 
standalone executable file types. 

Don Thomas of Artisan Software 
is one of the Portfolio’s leading 
graphics creators, and he has done 
some programming himself. 

He was nice enough to include 
his latest effort, ViewPort, and sev- 
eral animation files on Re:Port Disk 
#5, 

The program will let you view 10 
Portfolio graphics at once ona desk- 
top PC. 

Please note that ViewPort will 
not work on your Portfolio; it re- 
quires a desktop IBM compatible 
computer with VGA graphics. 

Please read the on-disk documen- 
tation file VIEWPORT.DOC for 
more information on howto use this 
great program. 

For those of you who would like 
to view and create your own graph- 
ics on the Portfolio, or even edit the 
graphics that you save with SeeWork 
(see Page 1), there are two Re:Port 


ViewPort, PDRAW, 
and PGCVIEW, 
along with some 
interesting graphics 
and animations are 
on Re:Port Disk #5 
in the \GRAPHICS 
subdirectory. 
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utilities in the \GRAPHICS 
subdirectory to allow you to do just 
that. 

Let’s start with PGCVIEW, the 
Portfolio file viewing utility. Using 
this program is simple — just type 
PGCVIEW along with the name of 
the .PGC graphic file that you wish 
to view. 

Remember also that the program 
Launch in our last issue will let you 
view .PGC graphics file, if you 
would prefer to do it that way. 

To edit graphics files, or to create 
files of your own, try PDRAW. 

PDRAW features some very ad- 
vanced graphics capabilities, includ- 
ing a large graphics cursor. 

When you start the program, you 
can load a .PGC file right away by 
typing PDRAW <filename>, where 
<filename> is the name of the .PGC 
graphic. 

When PDRAW begins, you will 
see the graphics cursor. 

To move the cursor, simply use 
the up, down, left, and right arrow 
keys. 

To increase the speed of the cur- 
sor, hit one of the number keys (1 
through 9, where nine is the fastest). 

Toclearthe screen, type W (shift- 
W). 


To draw while you move the cur- 
sor, hit the spacebar. To stop draw- 
ing, hit the spacebar again. 

To erase while you move the 
cursor, type e; type e again to stop 
erasing. 

PDRAW also includes some 
graphics object drawing commands. 
Youcan draw a line, abox, and even 
a circle. 

To draw a line, type 1. PDRAW 
will plot a point at the current posi- 
tion. 

Then, movethecursorto the other 
end of the line and type 1 again. The 
line will be drawn. 

To draw a box, type b. Move the 
cursor to the opposite corner of the 
box, and type b again. 

PDRAW will create the box. 

To draw a circle, type c where 
you want its center to be. Then, 
move the cursor away from the cen- 
ter point. That distance will be the 
radius of the circle. Type c again to 
draw it. 

Interesting effects can be created 
by combining these keys. 

For instance, to create a circle 
with a radius line on it, type c and 1, 
then move the cursor the length of 
the radius, and type c and | again. 

To save your graphic creation, hit 
s. If you supplied a filename to 
begin PDRAW, you will save over 
that graphic. 

If you didn’t supply a filename, 
then PDRAW will save the graphic 
as DRAW.PGC, which you can re- 
name after you exit the program. 

Speaking of exiting the program, 
type ESC to stop. 
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Featured 


Play Solitaire, and fun is in the cards 


Although the Portfolio is prima- 
rily a business machine, we’ve had 
quite a few requests for Port games 
in our contest entries. Here is one 
that should help you pass some time 
on those long business trips: Soli- 
taire. 

Toplay the game, copy SOL.EXE 
from Re:Port disk #5’s \SOL direc- 
tory to your Portfolio. Type SOL to 
begin. 

Solitaire plays by most of the 
rules of Klondike Solitaire. To win, 
you must move all the cards (in 
order from Ace to King) by suit to 
the top of the screen. 

The Portfolio deals the cards in 
seven piles; each number pile con- 
tains that number of cards to begin 
with. You may move cards from 
pile to pile, placing black cards (the 
spades and clubs) on red cards (the 


Services 


Solitaire is on 
Re:Port Disk #5 in 
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The Solitaire game screen 


diamonds and hearts) and red cards 
on black cards, in numerical order 
(i.e. a red 5 on a black 6). 

To move cards, type M and the 
number of the pile with the card to 
move followed by the number of the 
pile to move the card to. For in- 
stance, to move a card in pile 5 to 
pile 7, type M57. 

Piles without any cards left on 
them are marked with an X. You 
may move any King onto an X. 


You may also move cards from 
the leftover cards (the deck) to the 
numbered piles. To do so, type M, 
followed by D for deck and the 
number of the pile (i.e. MD2). 

If you would like to look through 
the deck, type D alone. That will 
scroll through the deck, looking at 
the third card from the top each 
time. 

But what about winning? You 
must move cards to the “top” by 
using the familiar Move command 
along with a T. For instance, to 
move an Ace in the third pile to the 
top, type M3T. To move a card in 
the deck directly to the top, type 
MDT. 

If you give up on this hand but 
would like to try again, hit the 
spacebar to reshuffle. To quit, hit 
ESC. 


Get faster shipping and custom Portfolio programs 


Re:Port provides many other ser- 
vices to its subscribers other than 
the newsletter. 

Check out the Savings Surge flier 
for information on how you can 
save on Atari products for the Port- 
folio. Note that shipping is free via 
Parcel Post, which can take four to 
six weeks. 

However, UPS 2nd-Day air ship- 
ping is available. Because of a UPS 
price increase, we must now ask for 
a $7.00 an item extra charge for the 
2nd-Day air service. We cannot de- 


liver via UPS to P.O. Boxes, so 
please provide a street address if 
your Re:Portaddress isa P.O. Box. 
If you know someone who would 
like a Portfolio, we offer a complete 
Port set for only $350: A Portfolio, 
a 64K RAM card, a Parallel Inter- 
face, anda year ofRe:Port. You will 
receive a $5 gift certificate, too! 
Also, Re:Port provides all of its 
subscribers free customer support 
via the telephone or online with two 
major services. Contact us at (918) 
258-2062 between 1 p.m. and 7 


p.m. Central time Monday through 
Friday, or anytime at 73770,2021 
on CompuServe or at the address 
DAVESTEWART on GEnie. 

If you need a special program 
written for the Portfolio, Re:Port 
offers custom programming ser- 
vices. Please contact us at the above 
phone number, or write to Re:Port, 
Custom Programming, 1618 S. 
Beech Ct., Broken Arrow, OK 
74012-6205. We will discuss your 
program needs and set up an hourly 
rate schedule. 
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For Beginners 


How to get files off a floppy onto the Port 


This issue’s Beginners Column 
is an answer to the following letter 
from John Dunnigan of Coconut 
Creek, Florida: 

“How do I get into the disk you 
are sending me? (I have both an 
NEC Multispeed and First Publisher 
software ... how do I get your disk 
on the screen?) 

“When I havethem on my screen, 
how do I transfer the files I want to 
my Portfolio?” 

We hear this question quite a bit 
from Portfolio users. 

Unfortunately, there are many 
ways to transfer files to the Portfolio 
from a desktop machine’s disk, 
which can be confusing. 

First of all, exit from any soft- 
ware that you are running on your 
desktop, including all menus and 
shells, until youareata DOS prompt. 

Mr. Dunnigan says he has First 
Publisher software, which isn’t nec- 
essary to transfer files; in fact, it gets 
in the way. Exit it. 

You can tell that you’re ata DOS 
prompt, because it is usually a letter 
followed by a colon, and maybe a 
slash character, or the name of a 
directory (for instance, A:, A:\, 
C:\PORT). 

When youare atthe DOS prompt, 
place the current Re:Port disk into 
the floppy drive. 

Type the name of that drive fol- 
lowed by a colon and the enter key 
(i.e. A: <enter>). 

To “get the disk onto the screen,” 
type the DIR command. 

The Re:Port disk is split into 
what are called subdirectories. 


These will display on your disk. 
In order to get into one of those 
subdirectories, you need to type the 
CD command (which stands for 
Change Directory). 

For instance, you want to copy 
Solitaire to your Portfolio, so you’d 
type CD SOL. 

Type DIR again to see the con- 
tents ofthat directory. The filename 
SOL.EXE should appear. 

To get back to the “top” direc- 
tory, the one which names all the 
other subdirectories, type CD \ (the 
backslash character). 

Now we know how you can see 
all of the files. How do you transfer 
them to the Portfolio? 

This is a much more difficult 
question to answer, because it de- 
pends on what kind of hardware you 
are using. 

There are three different ways to 
transfer information to the Portfo- 
lio: Via the Parallel Interface, via 
the Serial Interface, or via the PC 
Card Drive. 

Each ofthese solutions requires a 
piece of hardware. 

If you don’t already have any of 
these pieces of hardware, and you’ re 
budget is tight and you want the 
most simple method, go with the 
Parallel Interface. 

If you are not afraid of opening 
up your PC and installing an expan- 
sion card, you should try the PC 
Card Drive. 

We don’t recommend the Serial 
Interface for beginners, unless you 
are very familiar with modems and 
communications. 


The Parallel Interface from Atari 
comes with a disk of software that 
you must install on your PC. Place 
the Parallel Interface disk to in your 
computer, type FT, and remove it 
from your drive, replacing it with 
your Re:Port disk (or copy either 
disk to your hard drive). 

Connect your Parallel Interface 
to the Portfolio, and run a parallel 
cable from your Portfolio to the 
printer port on your PC. Ifyou need 
the cable, Re:Port offers them for 
$10; but you may also find them at 
your local computer store. 

The software is already installed 
on your Portfolio, under the setup 
menu (Atari-S). It is the File Trans- 
fer option, which is the last selec- 
tion. 

When you select File Transfer, 
you can then hit R for Receive. The 
Portfolio will ask you what file you 
want to receive, and where you want 
it to go. 

In our example above, tell the 
Portfolio that you want to receive 
SOL.EXE, and tell it you want it to 
go on the C: drive (or the A: drive if 
you have a RAM card); type in 
C:SOL.EXE. 

That’s it in a nutshell. Now you 
can disconnect your Port from the 
Parallel Interface and use the soft- 
ware. 

If you still need help, or if you 
need help using a Serial Interface or 
aPC Card Drive, please call Re:Port 
at 1-918-258-2062 between | p.m. 
and 7 p.m. Central Time for a step- 
by-step talk-through of transferring 
files. 


Re:Port 


Port problems 


Page 9 


Happy ending to PC Card Drive horror story 


By Zane Binder 

The Portfolio Card Drive - at 
least for me - had problems playing 
with a full deck. 

The saga began that fateful day 
the Portfolio entered my life: “It’s 
the best, fastest way to transfer files 
to the PC,” the cherubic salesman 
said. “The circuit board simply 
slides in any expansion slot.” 

A big red flag popped into my 
mind’s eye. I remembered another 
salesman’s words and a nightmar- 
ish time bolting exhaust headers to 
anauto engine. He was right, though: 
it did “just bolt on”... but only after 
chopping the fenderwells apart. 

Regardless, hope springs eternal, 
and a scant 30 minutes later I tore in 
the door, ripped the cover off my 
386 SX20 clone, and slid the card 
drive board into a 16-bit slot. 

I powered up ... and promptly 
received a “Card is Write-Protected” 
message. Did I foul up ... was it the 
I/O addresses ... or did I have a bad 
board? Numerous calls to Carl at 
Atari Customer Service finally 
solved the mystery: I had one of the 


Online services 


world’s few (allegedly) dead collec- 
tions of resisters, chips, and capaci- 
tors. But this conclusion came only 
after 15 hours of changing I/O ad- 
dresses and endlessly editing the 
Config.Sys file. 

I packed up the dead board and 
sent it to Atari; maybe, I fantasized 
in my disillusionment that the Port- 
folio would make a nice planter. 

Ten days hence the mailman re- 
turned; breathlessly I installed the 
board. Breathlessly I booted the 
machine; breathlessly I screamed as 
the machine refused to recognize 
the card drive as “D.” 

That day faded to night with hours 
of calls to Customer Service. 

“Maybe you’ve got a dead ex- 
pansion slot,” Atari’s Carl reasoned. 

Perhaps my Portfolio’s destiny 
in life really was as an expensive 
planter. 

As Dad used to say, when all else 
fails, follow the directions. 

So at age 44, only about 40 years 
late, I began listening. I again read 
the manual. I studied my computer 
books ... tons of them. I pondered, 


sweated, cursed and paced. Then, 
from nowhere, the light dawned. 
The manual said put the drive board 
in an 8-bit slot. I had it in a 16-bit 
slot ... but Atari, my books, and my 
clone’s maker ALL said an 8-bit 
board works fine in a 16-bit slot. 
Besides, the 8-bit slots were jammed 
tight nextto the hard drive and would 
only accommodate “shorty” boards. 
The drive board was way too long... 
surely Atari’s not so fiendish they 
would design a long board to fit an 
abbreviated slot. Still... 

I attacked my computer with a 
screwdriver; I pried the hard drive 
up and out of the way (accompanied 
by the yelp of protesting metal) but 
professionally secured it in its new, 
skewed location with a Q-Tip stick. 
After squeezing the l-o-n-g board 
into the short slot - and bending it to 
an obscene angle, I powered the 
system. 

Glee and success! But the results 
defy every expert’s advice. 

There is a dark side to the story, 
though: now I have to spend money 
for a real planter! 


Quick tip: Leave your printer at home and FAX 


With a Portfolio, a serial port, a pocket modem, and 
a subscription to CompuServe or GEnie, it is possible 
to send FAX messages to any machine in the world. So 
leave your printer behind; if you need a printout, FAX 
See the instructions of your 
favorite online service to find out how to send a FAX. 


it to a hotel machine. 


©. 


ON DISK 


Catalogues of the new files avail- 
able on CompuServe and GEnie 
are available on your Re:Port Disk 
#5 in the \ONLINE directory. 
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Use these procedures to quickly create graphics 


In our last advanced programming column, we dis- 
cussed how to add super-fast LCD graphics control to 
your Portfolio programs. We promised to delve into the 
internals of a 60 View-type program for this issue, but 
let’s put that off for another issue. 

Instead, let’s look first at how to do some of the more 
typical graphics functions can be used on the Portfolio. 

If you’re a Turbo Pascal programmer, check in the 
\SOURCE directory on Re:Port disk #5. You will find 
PORTGRA.PAS, which can compile into a Turbo 
Pascal unit. It adds most of the graphics commands 
you’ll need to create a full graphics application for the 
Portfolio (all ofthe graphics programs in this issue were 
created using that unit). 

Although these procedures all access the LCD con- 
troller of the Portfolio, they aren’t the fastest drawing 
commands possible, simply because they are not writ- 
ten in assembly language. However, they are fast 
enough for everyday use, and the PGC functions add 
enough graphics capability to spawn many programs. 

Let’s look at each procedure one-by-one. 

PUTLCD(command, option : byte) 

This command is used to write a byte directly to the 
LCD controller. See the last issue for more information 
on this procedure. Actually, you will not use this 
command very often, because the other commands are 
more useful for screen drawing, as you will see. 

GRAPHMODE 

Call this command to set the Port into graphics 
mode. This also clears all graphics memory. Call this 
before the procedures that create graphics. 

TEXTMODE 

Call this command to return the Portfolio to text 
mode. This will also clear the screen. 

PLOT(x,y,color : integer) 

This is perhaps the most important procedure in the 
unit. Feed this the x and y coordinates of a point you 
want to plot (x ranges from 0 to 239; y ranges from 0 to 
63; the top left corner is 0,0) and the color of the point, 
which is either 0 (white) or 1 (black). 

CIRCLE(cx,cy,radius,color : integer) 

This procedure will draw a circle, given the center 
coordinates, the radius, and the color. If part of the 


ee PORTGRAPAS and other source code 


can be found on Re:Port disk #5 in the 


ON DISK \SOURCE directory 


circle extends beyond the screen area, it will not be 
displayed. 

DRAW(x|,y1,x2,y2,color : integer) 

This procedure draws a line between the first x,y 
coordinates and the second x,y pair in the selected 
color. 

LINE(x!,y1,x2,y2,color : integer) 

Line simply calls the DRAW function, for people 
who can remember LINE more easily. (DRAW is 
called DRAW so that programs can be compatible with 
Turbo Pascal version 3.0 graphics code. Programs 
written with TP3.0 will run on the Portfolio). 

BOX(topx,topy,botx,boty,color : integer); 

This procedure draws a box, when fed the opposing 
corners of the box (and it’s color). 

ANGLE(degree: real; cx,cy,radius,color : integer) 

Give this procedure an angle, and it draws a line of 
length RADIUS from the specified x,y coordinates at 
the given angle, where 0 degrees is vertical and 270 
degrees is to the left. 

SAVEPGC (filename : string) 

This procedure saves graphics memory into a .PGC 
file with the given filename. Compressing graphics 
memory into a .PGC file is one of the more daunting 
tricks of Portfolio programming; with this command, 
you don’t have to worry about re-inventing the wheel! 

LOADPGC (filename: string; keyed : integer) 

This procedure will load the given file. Be sure that 
it is a valid .PGC file, first. The KEYED variable is 
either 0 (don’t wait for a keypress afterward) or 1 (halt 
the progress of the program until a key is pressed). 

You’re free to use any and all of these commands to 
write your own Portfolio graphics programs. If you 
come up with something good, please send it to us via 
Email to 73770,2021 on CompuServe or to 
DAVESTEWART on GEnie, or to Re:Port programs, 
1618 S. Beech Ct., Broken Arrow, OK 74012-6205. 
We’d love to see what can be done. 
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User-to-user 


Portfolio users share tips on getting things done 


From G. Fuhrman (on GEnie): 

Re:Portarrived yesterday; thanks forthe new Launch! 
No more having to limit the length of filenames! I’m a 
bit baffled by the Battery Monitor program, though. 
Why use a TSR to do something the Diary can do? I 
can’t see any difference between running BAT and 
setting an alarm that says “Change my battery!”. Have 
I missed something? (Editor’s note: Well, how true! 
Sometimes, we always look for the hard way to do 
things. Thanks for the tip, and for the next one, too). 

Speaking of the Diary, I discovered an undocu- 
mented feature the other day (at least I can’t find any 
mention of it inthe manual). If you begin a Diary entry 
with a hyphen character, it becomes a date header 
(rather a time entry) for that day. Until today I thought 
this could only be done by preceding the entry with the 
date (e.g. 10/10 for October 10). 


From David M. Bunch: 

I would like to tell you ofa great .BAT file that would 
help many of your readers. I am nota writer, so just bear 
with me. First it is very possible to cut down on a lot 
of strokes with this .BAT file and is very useful for 
those who are still using a file manager. Save the 
following listing as D.BAT: 


Contest 


@echo off 

if %|!==!goto default 
if %1==w goto w 

if %|==p goto p 
:default 

dir /p 

goto end 

Ww 

dir /p/w 

goto end 


echo Make sure your printer is ready and 
pause 

dir > prn 

goto end 

send 

If you are using File Manager, put the cursor on the 
D.BAT file in the left-hand window, push F3, and then 
type d, w, or p. 

This will show the directory of the current drive in 
the regular format or the wide format, or will send it to 
your printer. (You must have a printer hooked up for 
this to work, though.) 

If you don’t use the file manager, you can run this 
.BAT file by typing D, D W, or D P, depending on 
which function you need. 


Put your name in lights with Re:Port Contest #5 


The winner of the last contest is Daniel Schwartz of 
Aurora, CO. He has anew copy of Instant Speller from 
Atari — we’ll expect those letters to Re:Port to be 
perfectly spelled, Mr. Schwartz! 

The prize for the current contest will be a bit more 
personal — an animation file of the winner’s name. 
You can use it to impress your friends, family, and 
clients with the power of the Portfolio. 

So fill out and send in a copy of the provided form. 
Contest deadline is June 15. 


Rise oe ee Rees i gs Ce ee Le IR ee, Sch ae z | 
: Re:Port Contest #5 | 
l Name: l 
| Favorite use of the Portfolio: | 
| cable ct eee a ee aaa ia § | 
| Favorite application (pick two): | 
| Editor Worksheet Address Book : 
l Diary Calculator l 
[a | 
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Dear Re:Port, 

I am interested in compiling the 
Turbo Pascal code that is included 
onthenewsletter disk, possibly with 
modifications. But I have found 
that the programs that I compile are 
much larger (3-4K) than those you 
provide as .EXE files. I would like 
to know what compiler options, etc., 
that you are using that may affect 
.EXE file size. 

Incidentally, I previously wrote 
about having a problem with 
PBASIC with the included test pro- 
gram, TEST47.BAS. The test pro- 
gram causes Error 1, out ofmemory. 

— Sam King, 
Dallas, TX 


Editor’s reply: All Re:Port pro- 
grams as written in Turbo Pascal 
and are compressed with the public 
domain program LZEXE, which is 
what makes them smaller. The pro- 
gram PKLITE willalso work. How- 
ever, this is not necessary to get the 
program to run. 

TEST47.BAS was distributed 
with the last version of PBASIC by 
error. As the name implies, TEST47 
works only with PBASIC version 
4.7. 


Dear Re:Port, 

Do you know if I will be able to 
run any version of WordPerfect, or 
one of its smaller versions 
(LetterPerfect?) if I upgrade my 
Portfolio with the 20 megabyte hard 
drive and the 512K expansion of- 
fered by XoteriX? Ifso, would you 
know if there would be any prob- 
lems with the display? 

— Emma Oh, 
Philadelphia, PA 


Editor’s reply: Well, XoteriX 
no longer makes either product, but 
see “Industry News” on Page 3 for 
information about how to get the 
drive and the 512K upgrade. 

WordPerfect Jr. is said to work 
on the Portfolio; contact the com- 
pany for availability. Ms. Oh also 
had questions about 60View and 
Piano; please call us at (918) 258- 
2062 for complete assistance, as we 
need more information to diagnose 
your problems. 


Dear Re: Port, 

In Issue #4, you talked about 
dropping File Manager. You said, 
“File Manager means that you al- 
ways have the card in the slot, so 
you have to turn the Portfolio off 
and on just to save information to 
your RAM cards.” I just load the 
program into my C: drive and re- 
move the card. Why would you 
leave the card in the slot? Tme it 
takes about 10K, but I find FM very 
useful. 

I also wanted to tell you that my 
two favorite programs are the 
Backup/Restore program and the 
Battery Monitor program. 

— Gerald A. Simons, 
Bloomington, MN 


Dear Re: Port, 

The UPDATE.COM on the 
CHESS program hasa different date 
than the date of the UPDATE.COM 
on the FM card. Any significant 
differences? Also, I assume UP- 
DATE must be run on bootup, so I 
keep it in my C:> directory and run 
it via my AUTOEXEC.BAT as an 
UPDATE line. Any thoughts on 
this procedure? 


You recommend getting rid of 
the File Manager and using the 
LAUNCH function, noting that 
LAUNCH will save memory. I 
don’t followthis: LAUNCH=9,466 
bytes, while FM=7,570 bytes. What 
gives? 

— Eldin Fender, 
Clearlake, CA 


Editor’s reply (to the last two 
letters): Perhaps we weretoo happy 
with our own program LAUNCH to 
see that people actually like the File 
Manager program (FM.COM). 
However, please note that there is a 
difference in “disk space” and 
“memory.” LAUNCH takes up more 
disk space, but it leaves more 
memory available to applications 
(i.e., you can write a larger editor 
file). To each his or her own, though. 
We should have simply said that 
LAUNCH offers different capabili- 
ties, suchas the ability to view .PGC 
graphics files. 

About UPDATE.COM: Always 
use the version of UPDATE.COM 
that has the most recent date. To be 
sure, the most advanced version of 
UPDATE.COM that we know of 
was included on the disk that came 
with Re:Port issue #3. We usually 
keep the file on the C: drive in the 
\SYSTEM directory, and it does 
need to be loaded via the 
AUTOEXEC.BAT file. 


Please write to Re:Port with your 
questions and comments: 1618 S. 
Beech Ct., Broken Arrow, OK 
74012-6205. Please call 1-918-258- 
2062 between | p.m. and 7 p.m. 
weekdays for answers to technical 
questions. 


